.. _ceGnReSearchDevice:

ceGnReSearchDevice
==================
------------------




SYNOPSIS
--------


.. code-block:: none

  VT_I4 ceGnReSearchDevice(
    VT_I4 RealNode,
    DWORD nTimeout,
    VT_I4 IsBlocking,
    VT_PI4 pResultNode
  )



DESCRIPTION
-----------


- 원격 노드의 정보가 탐색된 상태에서 원격 노드의 정보를 재 탐색 합니다. ceGnIsSearchedDevice 함수를 통해 원격 노드 탐색 여부를 확인할 수 있습니다.



PARAMETER
---------


- RealNode : 실제 탐색(Search)할 원격 노드의 수를 설정합니다. RealNode 의 개수는 탐색할 원격. 노드의 개수보다 같거나 커야 합니다. 

- nTimeout :  원격 노드 탐색(Search) 시간을 밀리초(ms) 단위로 설정합니다. 1 개의 원격 노드를. 탐색하는데 걸리는 최소 시간은 30ms 입니다. 최소 탐색 시간은 다음과 같습니다. 

+----------------+--------------+
| 원격 노드 개수 | 탐색 시간    |
+================+==============+
| 1개            | 30ms*1 =30ms |
+----------------+--------------+
| 2개            | 30ms*2=60ms  |
+----------------+--------------+
| 3개            | 30ms*3 =90ms |
+----------------+--------------+

.. note::
  실제 탐색 시간이 너무 짧을 경우 요구되는 모든 원격 노드를 검색할 수 없으니, 탐색

  시간을 충분히 설정해 주시기 바랍니다.

- IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 결정합니다. 

+--------------+------------------------------------------------------------------------------------------------------------+
| Value        | Meaning                                                                                                    |
+==============+============================================================================================================+
| 0 (CE_FALSE) | 블록(Blocking)을 하지 않습니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에도 윈도우 이벤트를 처리합니다. |
+--------------+------------------------------------------------------------------------------------------------------------+
| 1 (CE_TRUE)  | 블록(Blocking)을 합니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에는 윈도우 이벤트가 처리되지 않습니다. |
+--------------+------------------------------------------------------------------------------------------------------------+


- pResultNode : 이 매개변수를 통하여 탐색된 원격 노드의 수를 반환합니다. 


.. hint::
  

  ㈜ 커미조아의 디바이스 초기값은 어떤 값으로 설정됩니까?

  

  ceGnSearchDevice() 함수를 통해 탐색한 원격 노드 초기화 시 각 속성별로 사용되는 기본값은 “Appendix::C Motion Default Parameter”를 참조하시기 바랍니다.




RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+


.. seealso::
  :ref:`ceGnSearchDevice`

  :ref:`ceGnUnSearchDevice`

  :ref:`ceGnIsSearchedDevice`